

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>Preparing for Migration &mdash; RWC Converter v1.0 documentation</title>
    <link rel="stylesheet" href="_static/default.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '',
        VERSION:     '1.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="top" title="RWC Converter v1.0 documentation" href="index.html" />
    <link rel="next" title="The Migration Process" href="the_conversion_process.html" />
    <link rel="prev" title="Robert’s configuration management documentation" href="index.html" /> 
  </head>
  <body>
    <div class="related">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             accesskey="I">index</a></li>
        <li class="right" >
          <a href="the_conversion_process.html" title="The Migration Process"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="index.html" title="Robert’s configuration management documentation"
             accesskey="P">previous</a> |</li>
        <li><a href="index.html">RWC Converter v1.0 documentation</a> &raquo;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
            
  <div class="section" id="preparing-for-migration">
<span id="get-started"></span><h1>Preparing for Migration<a class="headerlink" href="#preparing-for-migration" title="Permalink to this headline">¶</a></h1>
<p><em>Because some steps of the document migration process require a Windows machine,
this manual is directed toward the Windows platform.
This page will outline the setup and use of the tools required for the migration project.
The actual steps and procedures of the migration process are described on the</em>
<a class="reference internal" href="the_conversion_process.html#the-migration-process"><em>Migration Process</em></a> page.</p>
<p>Minimally, the python interpreter must be installed in order to run this migration utility.
This utility was developed and tested on <strong>Python 2.7.1</strong> and is only guaranteed to work properly
with that specific version (other 2.7.x versions should be fine). Python is an interpreted, scripting
programming language with an extensive standard library and lent itself well to this project.
The basic process for downloading and installing python is outlined
below.  There are two other frameworks (<a class="reference internal" href="#install-django"><em>Django</em></a> and <a class="reference internal" href="#install-sphinx"><em>Sphinx</em></a>)
that can be added to the python installation that allow
the utility to manipulate data in some useful ways.</p>
<p>This migragion utility is designed to be run from the
command-prompt (cmd.exe).  The command prompt can be started by clicking start menu and then clicking run.
Type cmd.exe into the text box and click okay. Use the <tt class="docutils literal"><span class="pre">cd</span></tt> command to change
the current working directory as desired.</p>
<div class="section" id="installing-and-using-python">
<span id="install-python"></span><h2>Installing and Using Python<a class="headerlink" href="#installing-and-using-python" title="Permalink to this headline">¶</a></h2>
<p>First, download the appropriate installer for your computer from the <a class="reference external" href="http://www.python.org/getit/106">Python downloads page</a>.
Follow the steps and complete the setup operation.
The Python installer does not add the interpreter to the command prompt PATH environment variable.
On Windows XP, this is done as follows:</p>
<blockquote>
<div><ol class="arabic">
<li><p class="first">Right-click on My Computer and select &#8216;Properties&#8217;.</p>
</li>
<li><p class="first">In the &#8216;System Properties&#8217; windows select the &#8216;Advanced&#8217; tab.</p>
</li>
<li><p class="first">Towards the bottom of the window, click the &#8216;Environment Variables&#8217; button.</p>
</li>
<li><p class="first">In the &#8216;Environment Variables&#8217; window under the &#8216;User variables for xxxxx&#8217;
section, do either &#8216;a&#8217; or &#8216;b&#8217; below:</p>
<ol class="loweralpha">
<li><p class="first">If There is no variable named &#8216;PATH&#8217; in the listbox</p>
<blockquote>
<div><ol class="lowerroman simple">
<li>Click the &#8216;New&#8217; button.</li>
<li>In the &#8216;Edit User Variable&#8217; window type <tt class="docutils literal"><span class="pre">PATH</span></tt> in the &#8216;Variable name&#8217; textbox.</li>
<li>Type <tt class="docutils literal"><span class="pre">C:\path\to\python\installation</span></tt> (<tt class="docutils literal"><span class="pre">C:\Python27</span></tt> by default).</li>
</ol>
</div></blockquote>
</li>
<li><p class="first">If there is, select it and then click &#8216;Edit&#8217;.</p>
<blockquote>
<div><ol class="lowerroman simple">
<li>Select the &#8216;PATH&#8217; variable and click the &#8216;Edit&#8217; button.</li>
<li>Add a semi-colon to the end of the text in the &#8216;Variable value&#8217; textbox followed
by <tt class="docutils literal"><span class="pre">C:\path\to\python\installation</span></tt> (<tt class="docutils literal"><span class="pre">C:\Python27</span></tt> by default).</li>
</ol>
</div></blockquote>
</li>
</ol>
</li>
<li><p class="first">Click okay, okay, okay.</p>
</li>
</ol>
</div></blockquote>
<p>The Python interpreter should now be on your command prompt PATH. You can run the interpreter or python scripts by
typing <tt class="docutils literal"><span class="pre">python</span></tt> in the command prompt (cmd.exe). For Example:</p>
<div class="highlight-python"><pre>cd \path\to\my\script
python my-script.py myarg1 ...</pre>
</div>
<p id="install-django">After installing the Python interpreter and other desired packages (e.g. Django and Sphinx),
you are ready to begin data extraction and conversion to other formats. Use of the migration utility
is described on the <a class="reference internal" href="the_conversion_process.html#the-migration-process"><em>Migration Process</em></a> page.</p>
<div class="section" id="adding-django-to-python">
<h3>Adding Django to Python<a class="headerlink" href="#adding-django-to-python" title="Permalink to this headline">¶</a></h3>
<p>Adding Django will provide functionality for directly inserting the data into
the following supported relational databases: PostgreSQL, MySQL, SQLite, and Oracle.
Tables and relationships reflecting the data structure will automatically be created.
This project was developed and tested using <strong>Django version 1.3</strong>.</p>
<p>Follow these steps to add the Django package to python:</p>
<blockquote>
<div><ol class="arabic">
<li><p class="first">First, download the package from the <a class="reference external" href="https://www.djangoproject.com/download/">Django downloads page</a>.
Last I checked, click the link &#8216;Django-1.3.tar.gz&#8217; under the &#8216;Option 1&#8217; section.</p>
</li>
<li><p class="first">Use winzip, 7z, or another utility to extract the compressed django directory and files.</p>
</li>
<li><p class="first">In a command prompt (cmd.exe) change directory to the extracted Django folder.</p>
</li>
<li><p class="first">Run the command:</p>
<div class="highlight-python"><pre>python setup.py install</pre>
</div>
</li>
</ol>
</div></blockquote>
</div>
<div class="section" id="adding-sphinx-to-python">
<span id="install-sphinx"></span><h3>Adding Sphinx to Python<a class="headerlink" href="#adding-sphinx-to-python" title="Permalink to this headline">¶</a></h3>
<p>Same process as python.  This is only used for outputting the data to a restructuredText Sphinx project.
This output format was only created for my convenience during development.</p>
</div>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar">
        <div class="sphinxsidebarwrapper">
  <h3><a href="index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">Preparing for Migration</a><ul>
<li><a class="reference internal" href="#installing-and-using-python">Installing and Using Python</a><ul>
<li><a class="reference internal" href="#adding-django-to-python">Adding Django to Python</a></li>
<li><a class="reference internal" href="#adding-sphinx-to-python">Adding Sphinx to Python</a></li>
</ul>
</li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="index.html"
                        title="previous chapter">Robert&#8217;s configuration management documentation</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="the_conversion_process.html"
                        title="next chapter">The Migration Process</a></p>
  <h3>This Page</h3>
  <ul class="this-page-menu">
    <li><a href="_sources/preparation.txt"
           rel="nofollow">Show Source</a></li>
  </ul>
<div id="searchbox" style="display: none">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <input type="text" name="q" size="18" />
      <input type="submit" value="Go" />
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
    <p class="searchtip" style="font-size: 90%">
    Enter search terms or a module, class or function name.
    </p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="related">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             >index</a></li>
        <li class="right" >
          <a href="the_conversion_process.html" title="The Migration Process"
             >next</a> |</li>
        <li class="right" >
          <a href="index.html" title="Robert’s configuration management documentation"
             >previous</a> |</li>
        <li><a href="index.html">RWC Converter v1.0 documentation</a> &raquo;</li> 
      </ul>
    </div>
    <div class="footer">
        &copy; Copyright 2011, Robert Carlsen.
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.
    </div>
  </body>
</html>